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Über Net Yaroze 





Was Sie wissen müssen: 
Um mit Net Yaroze beginnen zu kónnen, sollten Sie gute Kenntnisse der Programmiersprache C und Grundwissen eines 
2D Graphik Generierungs-/Bearbeitungsprogramms haben. Außerdem wären zumindest elementare Kenntnisse eines 


3D Zeichenprogrammsund eines Sound-Toolshilfreich, um das Beste aus Ihrem Net Yaroze Kit zu machen. 


Das Net Yaroze Handbuch -Set 
Das Set besteht aus drei Teilbánden: 


° Installierungs-Handbuch (dieses Dokument): 


Eine einleitende Broschüre, die die Inhalte und Anforderungen des Net Yaroze Starter Kit erklárt. Zudem finden 
Sie Schritt für Schritt Anweisungen für den Set up der Net Yaroze Software auf ihrem PC und für den Gebrauch 


der Net Yaroze Software im System. 
° Benutzer-Handbuch: 

Ein Nachschlagewerk, das Details für das Erstellen von Software für das Net Yaroze System enthált. 
° Bibliotheks-Referenz: 


Ein Handbuch, das die Funktionen und Strukturen in den Net Yaroze Bibliotheken auflistet und beschreibt. 


Zusàtzliche Lektüre : 


Siehe „Zusätzliche Lektüre“ am Ende dieses Handbuches. 


Einleitung 


Der Net Yaroze Starter Kit ist eine Programmierungs-Umgebung für die Entwicklung von PlayStation Software auf Ihrem 
Personalcomputer. Arbeit, die auf einem PC entwickelt wurde, kann durch das Herunterladen auf eine spezielle 


PlayStation, die fúr Mitglieder von Net Yaroze erháltlich ist, gespielt werden. 


Die Mitglieder kónnen dann über einen einzigartigen, von Sony Computer Entertainment zur Vergiigung gestellten Web- 


Server ihre Werke und ihr Wissen mit anderen Mitgliedern teilen. 


Die Webseite für Mitglieder 





Verbindung zur Webseite für Mitglieder 


Mitglieder erhalten Zugang zu einem von drei Net Yaroze Servern mit folgenden URL: 


http://www.scei.co.jp/Net / für Mitglieder in Japan 
http://www.scee.sony.co.uk/yaroze / für Mitglieder in Europa 
http://www.sony.com/Yaroze / für Mitglieder in Nordamerika 


Die fúr die Verbindung notwendige Software 


Wir empfehlen Netscape Version 2.0 (oder eine neuere) als browser-Software für die Verbindung zur Webseite für 


Mitglieder. 


ID und Password 


Die ID und das Password fiir den Zugang zur Webseite für Mitglieder erhalten Sie mit Ihrem Willkommens-Paket. 


Mitglieder von Net Yaroze 


Ein Hauptteil von Net Yaroze ist die Aktivitát seiner Mitglieder auf ihrer Webseite. Sie kónnen dort nicht nur Ihre 
geleistete Arbeit teilen und Spaß an den Werken der anderen Mitglieder haben, sondern Sie können auch von einer Reihe 


anderer Aktivitáten profitieren, die die Webseite für Mitglieder anbietet. 


Weiter Informationen-Support 


Sony Computer Entertainment verwendet die Webseite für Mitglieder auch, um zusátzliche technische Informationen oder 


Daten anzuführen, die in der Dokumentation nicht aufscheinen. Bitte fragen Sie nach eventuell fehlenden Informationen. 


Inhalte des Paketes 





Folgende Gegenstánde sind im Net Yaroze Paket eingeschlossen: 


1. DTL-H3001 PlayStation für Net Yaroze Mitglieder oder 
DTLH-3002 PlayStation für Net Yaroze Mitglieder 
(Strom-Kabel und AV (RFU)-Kabel sind inkludiert) 
DTL-H3010 Controllers x 2 

DTL-H3020 Access card 

DTL-S3035 Net Yaroze Boot-Diskette 

DTL-S3045 Net Yaroze Softwareentwicklungs-Diskette 
DTL-H3050 Kommunikationskabel 

DTL-D3065 Installierung-Handbuch (dieses Handbuch) 
DTL-D3075 Benutzer-Handbuch 


ю ®© =a = S = on 


DTL-D3095 Bibliotheks-Referenz 


Anmerkungen: 


Bitte nehmen Sie zur Kenntnis, daf die Modellnummern des Paketes, die Sie erhalten, Je nachdem in welcher der drei Net 


Yaroze Miglieder-Regionen Sie wohnen, leicht variieren kónnen. 


' Net Yaroze ' ist das registrierte Warenzeichen des Projektes, es wird jedoch auch einfach ' Yaroze ' genannt. 


Arbeitsumgebung 





Sie brauchen die folgende Hardware und Software, um die Net Yaroze Entwicklungs-Umgebung zu benutzen. 


Hardware 


Ein PC/AT-kompatibler Computer mit einer 486DX2 66MHz CPU (oder schneller) 


Er sollte einen oder mehrere serielle Ports und ein Modem (mindestens ein 14,400 bps-Modem) fiir die Verbindung zur 


Yaroze Webseite haben. 


e Festplatte 

Mindestens 10MB freien Festplattenspeicher, um die grundlegende Entwicklungs-Umgebung zu installieren. 
e Arbeitsspeicher 

Mindestens 4MB RAM 


e CD-ROM-Laufwerk 


e Display 
Für den PC SVGA Bildschirm 
Für die PlayStation Normaler Fernseher mit Videoeingang 
(idealerweise mit Multi Format-Moglichkeiten) 
e Maus 
Software 


MS-DOS Version 5.0 (oder neuere) 


Windows 3.1 oder Windows 95 


Setup 


Hardware-Verbindung 


Versichern Sie sich, daß die Netzschalter des PC und der Net Yaroze PlayStation ausgeschaltet sind. Verbinden Sie den 
seriellen Port des PC und die PlayStation mit dem Kommunikationskabel, wie in der Abbildung unter beschrieben, und 


stecken Sie dann die Access card in den Speicherkartenschlitz 1 der PlayStation. 
Verbinden Sie nun mit dem zur Verfiigung gestellten AV-Kabel die PlayStation mit dem Fernseher. 


Um über das Internet Zugang zur Webseite für Net Yaroze Mitglieder zu erhalten, benótigen Sie ein separates Modem, 


eine Telefonleitung, ein Account bei einem Internet Service Provider und einen auf Ihrem PC installierten Web Browser. 


YAROZE Members' 
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Software Set Up 


Für die PlayStation 
Es ist kein besonderer Set Up-Vorgang nótig. Die Entwicklungsumgebung wird automatisch geladen, wenn Sie die Net 
Yaroze Boot-CD in die Net Yaroze PlayStation geben, die Access card in den Speicherkartenschlitz 1 stecken und die 


Stromtaste einschalten. Das folgende Bild wird auf Ihrem Fernseher erscheinen: 
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Für den PC 


Ordner-Kopien 

Geben Sie die beigelegte Net Yaroze Software Entwicklungs-CD (hiernach ' CD-ROM ') in das CD-ROM-Laufwerk des PC 
und kopieren Sie mit Hilfe von DOS XCOPY oder mittels des Windows Program-Manager/Explorer die Inhalte jedes 
Ordners auf die Festplatte. (Im CD-ROM-Verzeichnis finden Sie zwei Ordner namens PSX und GNU. Sie kónnen diese 
Ordner irgendwo auf die Festplatte kopieren.) Im unten angefúhrten Beispiel werden die PSX und GNU-Ordner auf das C- 


Laufwerk kopiert. 


Das Umschreiben von config.sys 


Uberpriifen Sie die Inhalte von config.sys im Verzeichnis der C-Laufwerks und sehen Sie nach, ob ansi.sys beinhaltet ist. 


Sollte es nicht vorhanden sein, fügen Sie folgende Zeile hinzu und starten Sie das System neu: 


devicehigh=C:\WINDOWS\ansi.sys 


Das Umschreiben der Batch-Datei 


Im Ordner PSX befindet sich eine Datei namens djsetup.bat, die Sie bereits auf die Festplatte gespeichert haben. Ihre 
Inhalte sind wie folgt: 

@echo von 

set DJGPP=c:/psx/djgpp.env 

PATH %path%;c:\psx\bin;c:\gnu\bin 


set TMP=c:\tmp 
set DTLH3000=0x3f8,4,9600 


Wenn Sie die PSX- und GNU-Ordner nicht direkt auf das C-Laufwerk kopiert oder wenn Sie andere Namen verwendet 
haben, ändern Sie diese Datei, sodaß die Inhalte dem Verzeichnis und den Namen entsprechen, in das Sie die Ordner 


kopiert haben. Wie Sie dabei vorgehen wird im folgenden beschrieben: 


Anmerkung: 
Da die Datei von einer CD-ROM kopiert wird, kann sie nur gelesen werden. Verándern sie dies vor dem Bearbeiten in DOS, 
wie nachstehend beschrieben: 


CAPSX > attrib-r djsetup.bat (wo 'c:\PSX' der Pfad ist) 





° Die zweite Zeile ist der Set Up der Umgebungsvariable DJGPP.Die Umgebungs-Set Up-Datei des Compilers ist angegeben. 
Wenn nötig, modifizieren Sie den c:/psx Teil, sodaß er sich auf den korrekten Pfad und Namen des kopierten 
Ordners bezieht. Beachten Sie, daß Sie ' / ' (Schrágstrich nach vor) verwenden müssen, um den Pfad nur für diese 


Umgebungsvariable abzugrenzen. 


. Die dritte Zeile ist der Set Up der Umgebungsvariable PATH. Wenn nótig, schreiben Sie den c:\psx und den c:\gnu 


Teil um in den Namen und den Pfad des kopierten Ornders. 


. Die vierte Zeile ist der Arbeitsordner. Sollte c:/tmp nicht geeignet sein, erstellen Sie einen Ordner und setzen Sie 


diesen ein. Ándern Sie die Zeile etwa zu folgendem: 
set tmp=c:\yaroze\wrk (wo ' wrk ' Thr bevorzugter Arbeitsordner ist) 
° Die fünfte Zeile ist der Set Up für die Kommunikation zur Net Yaroze PlayStation. Geben Sie diePort-Adresse, IRQ und die 


Geschwindigkeit (in dieser Reihenfolge) an. Wenn Sie COMI verwenden, benutzen Sie 0X3F8 und IRQ4 als 
Adresse und IRQ. 


° Geben Sie 0X2F8 als Adresse an und IRQ3, wenn Sie COM2 benutzen. 


° Datentransferraten von bis zu 115200bps werden unterstützt. Geben Sie je nach Prozessorleistung Ihres PC 


entweder 9600, 19200, 38400, 57600 oder 115200 an. 


° (Bitte beachten Sie, daß Sie für die Verwendung anderer Geschwindigkeiten als 9600 baud eine 
standardformatierte PlayStation Speicherkarte in Speicherkartenschlitz 2 Ihrer Net Yaroze PlayStation geben und 
die Geschwindigkeit mittels SIOCONS ándern müssen. (Siehe Kapitel 17 des Net Yaroze Benutzer-Handbuchs für 
Details über SIOCONS.) 


Ausführung der Batch-Datei, 


Führen Sie die umgeschriebene Batch-Datei djsetup.bat wie folgt vom PSX-Verzeichnis (oder dem von Ihnen gewáhlten 


Ordnernamen) in DOS (oder einem DOS-Fenster in Windows) aus: 
C:\PSX>djsetup (wenn ' PSX ' Ihr gewáhlter Ordnername ist) 


Dies vervollstándigt die Vorbereitung der Entwicklungsumgebung. 


Los geht's 


Mit den vorhandenen Muster- und Quick Start-Programmen kónnen Sie den Set Up Ihres Net Yaroze Systems überprüfen, 


erste Programme erstellen und ausprobieren. 


Erfahrene Programmierer kónnen die ausfúhrlichen Erklárungen im folgenden Abschnitt tiberspringen und gleich mit dem 
Abschnitt „Muster-Programme“ dieses Kapitels fortfahren. Der Abschnitt „Quick Start“ erklärt denselben Ablauf, gibt 


jedoch mehr Details über die Net Yaroze Software Entwicklung. 


Quick Start 


Das ' Quick ' Verzeichnis auf der Net Yaroze PC CD enthált einige Quick Start Testprogramme. Sie haben es 


wahrscheinlich zusammen mit der gesamten Net Yaroze Software auf Ihre Festplatte kopiert. 


Mit dem Quick Start Programm kónnen Sie auf schnelle Weise überprüfen, ob in Ihrem Net Yaroze System alles 


funktioniert. 


Net Yaroze Programm entwicklung-Überblick 
Im folgenden finden Sie die grundlegenden Schritte zur Entwicklung von Software auf dem Net Yaroze System (siehe Net 


Yaroze Benutzer-Handbuch, Kapitel 13, für mehr Details zur Entwicklung). 


1. Erstellen / bearbeiten Sie Textdateien, die den C-Code enthalten. 
Dieser wird auch ,,Quellcode“ genannt. Die Dateien heifen normalerweise 'name.c' (wenn 'name' der ausgewáhlte 


Dateiname ist). 
(Zwei Quellcode-Dateien befinden sich bereits im Quick-Verzeichnis: tuto0.c und tutol.c.) 


2; Kompilieren und verbinden Sie die C-Dateien, um die ausführbare Datei zu schaffen (das fertige Programm bzw. 


die fertige Anwendung). 
(Im Testbeispiel unten benutzen wir ein „makefile“, das dies auf den Befehl „таке“ ausführt.) 


3. Benutzen Sie das SIOCONS-Tool, das Sie als Teil Ihrer Net Yaroze Software erhalten haben, um eine Verbindung 


zwischen Ihrer Net Yaroze PlayStation und Ihrem PC zu erstellen. 
4. Starten Sie das ausführbare Programm. 


5. (In diesem Testbeispiel gibt es zwei Batch-Dateien, batch0 und batch1, die Sie benutzen kónnen, um die 


ausführbaren Dateien ('executables') des Testprogramms zu starten.) 


Das Kompilieren und Starten der Quick Start Programme - Schritt für Schritt 
1. Installieren Sie Ihre Net Yaroze PlayStation wie im Installierungs-Handbuch beschrieben: verbinden Sie die Net Yaroze PlayStation 
mit Ihrem Fernseher und PC, und stecken Sie einen Controller in PlayStation-Controller-Port 1. 
2; Schalten Sie Ihren PC, Fernseher und Ihre Net Yaroze PlayStation ein und warten Sie bis Sie die unten 


dargestellte Anzeige (ready-to-go screen) sehen. 
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Dieser Bildschirm sollte innerhalb von 30 Sekunden nach dem Einschalten oder Resetting der Net Yaroze PlayStation erscheinen, nach den Logos 


von Sony und der PlayStation. 


id Óffnen Sie eine MS-DOS-Fenster auf Ihrem PC und rufen Sie die Net Yaroze Batch-Datei djsetup.bat vom PSX- 


Ordner (oder dem von Ihnen gewáhlten Verzeichnis) auf: 
c:\PSX>djsetup (wenn 'PSX' Ihr gewählter Net Yaroze Ordnername ist) 


2. Kompilieren Sie die Quick Start Programme. Tippeñie „make“ beim DOS-Prompt ein, um die ausführbaren Programme 


aus den Quelldateien zu erstellen. 
c:\psx\quick>make 


3. Starten Sie das SIOCONS-Tool(Sie müssen das Quick Verzeichnis als einen Pfad für SIOCONS in Ihrer autoexec.bat- 


Datei installiert haben.) 
c:\psx\quick>siocons 
oder, wenn Sie die Baudrate schon verándert haben, geben Sie folgendes ein: 
c:\psx\quick>sicons -B<baud rate» (statt '<baud rate>' geben Sie Ihren gewählten Wert ein) 
4. Jetzt sind Sie in SIOCONS, das die Verbindung zwischen Ihrem PC und der Net Yaroze PlayStation erméglicht. 


Thre Bildschirm sollte in etwa folgendes anzeigen: 


c:\psx\quick>siocons -B115200 


siocons -- PlayStation debug system console prog 
for DTLH3000 1996/05/10 00:00:03 
type F1 ----» display help 


when hung up try type ESC 
I/O addr = 0x03F8, IRO=4 (vect=0x000C,8259=20) 
BAUDRATE = 115200 


5. Uberpriifen Sie, ob SIOCONS korrekt funktioniert, indem Sie die Return-Taste driicken: wenn alles in Ordnung ist, wird das 
SIOCONS-Prompt, ein doppelter Pfeil nach rechts, erscheinen: >> 


6. Starten Sie die Quick Start Batch-Dateien. 


Drücken Sie erst [F3] auf Ihrer PC Tastatur, wodurch daAuto[1] : Prompt erscheint. Geben Sie dann den 


Namen der Batch-Datei ein: batch0. 

Zum Beispiel (nach dem Drücken von [F3] auf der PC Tastatur): 
Auto[1]:batchO 

Batch0 wird heruntergeladen und startet tuto0.exe. 


7. Sofort nach dem Beginn des Herunterladens erscheinen diesbezüglich Mitteilungen auf dem Bildschirm, wie in 


etwa die folgenden: 


tutoO [ .text] address:80100000-801001ef size:0001f0  0001f0: lsec. 

tutoO [.rdata] address:801001f0-8010020f size:000020 000020: lsec. 

tutoO [ .data] address:80100210-8010035f size:000150 000150: 2sec. 

tutoO [.sdata] address:80100360-801003df size:000080 000080: 2sec. 
8. Der Fernseher zeigt die Mitteilungen des Herunterladens áhnlich wie folgt: 


BINARY DATA TRANSFER - BWR 

ADRS = 80100000 

SIZE = 000001F0 BYTES 

INTO BURST TRANSFER SUM:111F0/1F0 BYTES 
DONE. 


Das Starten und das Beenden eines Programms 


Tuto0 (aufgerufen durch batch0) schreibt "Hello World!' im SIOCONS auf dem PC und wird automatisch beendet. 


Wenn Sie ein Programm startet und beendet haben, setzt sich die Net Yaroze PlayStation zurück und zeigt den ,,ready-to-go 
screen“ an, wie unter Punkt [2] von „Das Kompilieren und Starten der Quick Start Programme - Schritt für Schritt 


angeführt. SIOCONS zeigt wieder sein Prompt an (>>). 


Sind die PlayStation und der PC wieder zurückgesetzt, kónnen Sie das zweite Quick Start Programm, tutol, starten, indem 
Sie die Schritte befolgen, die oben in [8] und [9] von ,,Das Kompilieren und Starten der Quick Start Programme - Schritt 


für Schritt“ beschrieben sind. 


Tutol (aufgerufen durch batch1) schreibt „Hello World!“ auf dem Fernseher. Beenden Sie dieses Programm, indem Sie 


SELECT auf dem Controller drücken. 


Aussteigen aus SIOCONS 
Um aus SIOCONS auszusteigen und zum MS-DOS-Prompt zurückzukehren, drücken Sie [F10] und dann [F2] auf Ihrer PC- 


Tastatur oder drücken Sie [Esc]. 


Das Benutzen der Test-Dateien 
Die Quelldateien, das „makefile“ und die Batch-Dateien sind einfache Textdateien, die Sie leicht bearbeiten können (z.B 


indem Sie den Text-editor in DOS verwenden), um Ihre Inhalte zu sehen. 


Um den Tuto0.c Quellcode zu bearbeiten oder anzuschauen, geben sie folgendes ein (bei Verwendung des Text-editors in 


DOS): 


e:\>psx\quick>textedit tuto0.c 


Schauen Sie sich den Test und andere Muster-Codes an, um sich damit vertraut zu machen, wozu das Net Yaroze Systems 


in der Lage und wie Sie das mittels C-Programmireung erreichen kónnen. 


Schnelle Verzeichnis-Inhalte 


C -Dateien für die Muster- | tuto0.c 
Programme 


tutol.c 


pad.c 


Batch-Dateien batchO (lädt und startet tuto0) 


batch1 (lädt und startet tuto1) 


Unterverzeichnisse 


eine Hilfsdatei für , make“ und einige Beispiel-makefiles 


Batch eine Hilfsdatei für Batch-Dateien (selbstausführende) und einige Beispiel-Batch- 
Dateien 


Baudrate eine Hilfsdatei für das Verándern der Baudrate (Datentransferrate bei 
Ladevorgángen vom PC) 





Muster-Programm 


Um Ihre Umgebung zu überprüfen, versuchen Sie das Herunterladen des vorhandenen Beispiel-Programms. (Der Quellcode 


und die ausführbare Datei befinden sich im psx\sample\check-Ordner - wenn „psx“ Ihr gewählter Dateiname ist.) 


Laden Sie den Muster-Code wie folgt herunter: 


1. 


Führen Sie „make“ aus: 


Führen Sie makebeim DOS-Prompt aus, um die Pfade, die in djsetup.bat angeführt sind, zu prüfen, und um 
sicherzugehen, daß das Programm korrekt kompiliert und verbunden ist. Gehen Sie wie folgt vor (der Text in 
Fettdruck zeigt Befehlszeilen-Eingabe an): 

C:\PSX\SAMPLE\CHECK>make 


gcc -Ol -g -c main.c -o main.o 


gcc -Xlinker -Ttext -Xlinker 80140000 -o main main.o 


Starten Sie SIOCONS 
Wenn das Programm kompiliert und verbunden ist, starten Sie SIOCONS wie folgt: 


C:\PSX\SAMPLE\CHECK>siocons 


siocons -- PlayStation debug system console program 
for DTLH3000 1996/05/10 00:00:00 
type Fl ----» display help 


when hung up try type Ctrl+C 
I/O addr = 0x03F8, IRO=4 (vect=0x000C, 8259=20) 
BAUDRATE = 9600 


Automatisches Herunterladen 


Driicken Sie die Funktionstaste [F3], um die Auto [1] - Eingabeaufforderung zu erhalten. Geben Sie fiir das 


automatische Herunterladen ,,auto“ ein und driicken Sie die Enter-Taste (siehe unten). 


Auto[1]: auto 


main [ .text] address:80140000-80140b4f size:000b50 000b50: lsec. 
main [.rdata] address:80140b50-80140c7f size:000130 000130: lsec. 
main [ .data] address:80140c80-801412ef size:000670 000670: 2sec. 
main [.sdata] address:801412f0-8014137f size:000090 000090: 2sec. 


PC=80140990, GP=801492f0, SP-801ffff0 


>>go 
ResetGraph:jtb=80047dd0,env=80047e18 


Nach der bisherigen Ausfúhrung, sollte das Muster-Programm-Fenster auf Ihrem Fernseher aufscheinen. 


Die Funktionen der Controller-Tasten sind wie folgt: 


Up key Erhóht die Anzahl der angezeigten 
Balle 

Down key Verringert die Anzahl der angezeigten 
Balle 





Muster-Programm 





Muster-Programm Make File 


CFLAGS = -01 -g 

LINKER = -Xlinker -Ttext -Xlinker 80140000 
RM = del 

PROG = main 

OBJS = main.o 


all: $(PROG) 


S(PROG): $(0BJS) 
$(CC) S(LINKER) -o $e $? 


main.o: main.c 
clean: 


$ (RM) $(PROG) 
$ (RM) $(OBJS) 


Muster-Programm Source List 


/* 

* Zeichnen von springenden Bállen auf den Bildschirm 

i Erhóhen oder Verringern der Ball-Anzahl durch up/down key 
* Laden der Sound-Daten von der Boot-CD und Abspielen 

de 

= Copyright (C) 1996 Sony Computer Entertainment Inc. 

= All Rights Reserved 

m 


/*Preparation include header */ 


#include <libps.h> 


#include “pad.h” 


/* ——————— ————— ————————— ————————— —Á———— аа 
Macros 

EE ui uu elc adu АЕРА mu aca aduc „аы нана ызчы et f */ 

/* Basis-Set Up */ 

define KANJI / * Schalter, um Kanji anzuzeigen * / 

#define OT_LENGTH Eb /* Ordering table number */ 

define MAXOBJ 1500 /* Maximale Anzahl von Sprites 

(Ballen)*/ 

#define MVOL 127 /* Main volume level*/ 

#define SVOL 127 /* SEQ volume level*/ 

#define DFILE 3 /* Dateianzahl*/ 





/* Macros für die Datenanordnung */ 

#define VH_ADDR 0x80090000 
#define VB ADDR 0x800a0000 
#define SEQ ADDR 0x80110000 


/* 


Macros ftir die Anzeigeflache */ 


#define FRAME X 320 /* Größe der Anzeigefláche 


(horizontal) */ 


define FRAME Y 240 /* Größe der Anzeigefláche 


(vertikal)*/ 


#define WALL X (FRAME Х-16) /* Größe der Ballmuster-Bewegungsfläche 


(horizontal) */ 


#define WALL Y (FRAME_Y-16) /* GróBe der Ballmuster-Bewegungsfláche 





(vertical) */ 








/* Macro für Aktionsflächen-Überprüfung */ 
#define limitRange(x, 1, h) ((x)=((x)<(1)? (1): (x) >(h) ?(h) : (x) )) 
/* Sie Se s= Se eee Se ар Se ee Se Se Se ый ыл Е — ————— —————— ——Ó—— € 
Externe Variablen 
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/ * Variablen fúr ordering table * / 
GsOT WorldOT[2]; 
GsOT TAG OTTags [2] [1««OT LENGTH]; 
/ * Variablen für Primitive * / 
PACKET GpuPacketArea[2] [MAXOBJ* (20+4)]; 
GsSPRITE sprt [MAXOBJ] ; 
/ * Variablen für Ballmusterbewegung * / 
typedef struct { 
u_short x, y; /* Location */ 
u short dx, dy; /* Speed */ 
) POS; 
/* Variablen für Controller */ 
volatile u_char *bb0, *bbl; 
/* Variablen für das Dateilesen */ 
typedef struct { 
char * fname; 
void *addr; 
CdlFILE finfo; 
} FILE INFO; 
static FILE INFO dfile[DFILE] = Í 
{"\\DATA\\SOUND\\STDO.VH;1", (void *)VH ADDR, 0}, 
{"\\DATA\\SOUND\\STDO.VB;1", (void *)VB ADDR, 0), 
{"\\DATA\\SOUND\\SAMPLE1L.SEQ;1", (void *)SEQ ADDR, 0}, 
}; 
/* Sound-Variablen */ 
short vab, seq; 
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static void init prim(); /* Initialisierung der 
Ballmustergraphik */ 
static void init point(POS *pos); /* Initialisierung der 
Ballmusterbewegungen*/ 
static long pad read(long n); /* Analyse des Controller-Zustandes */ 
static u long PadRead(long id); /* Lesen des Controller-Zustandes */ 
static void datafile search(); /* Dateiabfrage auf CD-ROM */ 
static void datafile read(); /* Dateilesen auf CD-ROM */ 
static void init sound(); /* Vorbereitung für Sound-Playback vom 


Speicher */ 


static void play_sound(); /* Sound-Playback Start */ 
static void stop_sound(); /*  Sound-Playback Ende */ 
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main () 
{ 
int nobj = 1; /* Anzahl der angezeigten Ballmuster 
(from 1)*/ 
GsOT жө /* Zeiger für Zeichnen von ОТ */ 
int d. AE XQ M /* Arbeitsvariablen*/ 
int activeBuff; 
GsSPRITE жер; 
POS pos [MAXOBJ] ; 
POS *pp; 
SetVideoMode( MODE_PAL ); /* PAL Mode */ 
/* SetVideoMode( MODE NTSC ); /* NTSC Mode */ 
GetPadBuf(&bbO, &bb1); /* Zuweisen eines Controller-Puffers */ 
datafile search(); /* Dateiabfrage */ 
datafile read(); /* Dateilesen*/ 
GsInitGraph(320, 240, 4, 0, 0); /* Zeichnen und Anzeigen der 
Umgebungseinstellungen */ 
GsDefDispBuff(0, 0, 0, 240); /* Wie oben */ 
/* 


When drawing in (0,0)-(320,240), display (0,240)-(320,480) (db[0]) 
When drawing іп (0,240)-(320,480), display (0, 0)-(320,240) (db[0]) 
E 


/* Ordering table information setting */ 
for (i = 0; i < 2; i++) Í 
WorldOT[i].length = OT LENGTH; 
WorldOT[i].org = OTTags[i]; 
} 
/* Font-Definition */ 
#ifdef KANJI /* Bei Kanji-Anzeige */ 
KanjiFntOpen(160, 16, 256, 240, 704, 0, 768, 256, 0, 512); 
fendif 
FntLoad(960, 256); 
/* Laden der Basis-Fontmuster in den Rahmenpuffer */ 
PntOpeni(l6. l6, 256, 200, 0, S12) 4 


/* Definition der Fontanzeigen */ 


init prim(); /* Anfangeeinstellung Primitive Puffer */ 
init point(pos); /* Anfangseinstellung Ballmusterbewegung */ 
init sound(); /* Anfangseinstellung Sound */ 

play sound(); /* Start des Sound-Playback */ 


/* Hauptschleife */ 

while ((nobj = pad read(nobj)) > O) { 
/* Doppelpuffer-Wechsel */ 
activeBuff = GsGetActiveBuff(); 
GsSetWorkBase((PACKET *)GpuPacketArea[activeBuff]); 


/* Ordering table clear */ 
GsClearOt(0, O, &WorldOT[activeBuff]); 


/* Aktualisierung der Ballmusterplazierung und Registrierung 
inm OT у 
sp = sprt; pp = pos; 
for (і = 0; i < nobj; і++, sp++, рр++) { 
/* Aktualisierung der horizontalen Koordinate */ 
if ((x = (pp-»x += pp-»dx) $ WALL X*2) >= WALL X) 
x = WALL X*2 - x; 
/* Aktualisierung der vertikalen Koordinate */ 
if ((y = (pp->y += pp->dy) $ WALL Y*2) >= WALL Y) 
y = WALL Y*2 - y; 


/* Einstellung neuer Koordinate für sprite primitive*/ 
Sp-»x = X; sp->y = y; 
/* Registration to sprite primitive ordering table */ 


GsSortFastSprite(sp, &WorldOT[activeBuff], 0); 





DrawSync(0); /* Warten auf das Ende des 


Zeichenvorgangs */ 


cnt = VSync(0); /* Warten auf vertikale Synchronisation 
* 
GsSwapDispBuff(); /* Doppelpuffer-Wechsel */ 


/* Registration to screen clear primitive ordering table */ 
GsSortClear(60, 120, 120, &WorldOT[activeBuff]); 


/* Zeichnen von primitive registered in OT */ 


GsDrawOt(&WorldOT[activeBuff]); 


/* Anzeige der Ballanzahl und der verstrichenen Zeit */ 
fifdef KANJI 











KanjiFntPrint("Num =%d\n", nobj); 
KanjiFntPrint ("Time =%d\n", cnt); 
KanjiFntFlush(-1); 

#endif 
EntPrint ("sprite = d\n", nobj); 
EntPrint ("total time = @d\n\n\n", cnt); 
EntPrint ("UP : INCREASE\n") ; 
FntPrint ("DOWN : DECREASE\n") ; 
EntPrint("L1 : PAUSE\n"); 
EntPrint("SELECT: END\n"); 
FntFlush(-1); 

] /* Hauptschleifenende */ 


/* Führen Sie dies durch das Drücken der SELECT-Taste und Verifizieren aus */ 
stop_sound(); /* Beengigung des Sound-Playback */ 


return(0); /* Beendigung des Programms */ 


#include "balltex.h" /* Textur des Ballmusters */ 


/* Initialisierung für Ballmustergraphik */ 
static void init prim() 
{ 

GsSPRITE * Sp} 

u_short tpage; 

RECT Fect; 


int ls 


rect.x = 640; rect.y = 0; 
rect.w = 16/4; rect.h = 16; 
LoadImage(&rect, balll6x16); 
GetTPage(0, 0, 640, 0); 


tpage = 
for (i = 0; i < 32; i++) { 
rect.x = 0; rect.y = 480+i; 
rect.w = 256; rect.h = 1; 
LoadImage(&rect, ballcolor[i]); 


/* Sprite-Initialisierung */ 

for (sp = sprt, i = 0; i < MAXOBJ; itt, 
sp->attribute = 0; 

sp->x = 0; 

sp->y = 0; 

sp->w = 16; 


sp->h = 16; 
sp->tpage = tpage; 


sp->u = 0; 
sp->v = 0; 
sp->cx = 0; 


sp->cy = 480+(1%32); 

sp->r = sp->g = sp->b = 0x80; 
sp->mx = 0; 

sp->my = 0; 

p->scalex = ONE; 

p->scaley = ONE; 

p->rotate = 0; 


un 


un 





un 


/* Initialisierung der Ballmusterbewegung */ 


static void init point(POS *pos) 


{ 


{nt ii 


for (i = 0; i < MAXOBJ; i++) í 


pos->x = rand(); 

pos->y = rand(); 

pos-»dx = (rand() % 4) + 1; 
pos-»dy = (rand() % 4) + 1; 
postt+; 





/ * Analyse des Controller-Zustandes * / 


y * 


Werte: 


sp++) 


{ 


/* Start der Koordinate X */ 


/* Start der Koordinate Y */ 


/* Bewegungsdistanz X 1<=x<=4) */ 


/* Bewegungsdistanz Y 1<=y<=4) */ 


-1: Beim Drücken der SELECT-Taste und Verifizieren 


15% Argument + 4: Beim Drücken der up-Taste und Verifizieren 


15% Argument-4: Beim Drücken der down-Taste und Verifizieren 


Beim Drücken der Ll-Taste ist Pause in Funktion * / 


static long pad_read(long n) 
{ 


u_long padd = PadRead(1); /* Lesen des Controller */ 
if (padd & PADLup) n += 4; /* Linke Steuerkreuztaste nach oben */ 
if (padd & PADLdown) n -= 4; /* Linke Steuerkreuztaste nach unten */ 


if (padd & PADL1) 
while (PadRead(1)&PADL1); /* Pause */ 


if(padd & PADselect) 
return(-1); /* Beendigung des Programms */ 
limitRange(n, 1, MAXOBJ-1); /* n is given value 1<=n<=(MAXOBJ-1) */ 


return(n); 


/* Lesen des Controller-Zustandes */ 
static u long PadRead(long id) 
1 
return(-(*(bb0+3) | *(bb0+2) << 8 | *(bb1+3] << 16 | *(bbl-2) << 24))¢ 
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/* Abfrage der Datei auf CD-ROM */ 
static void datafile search() 
{ 
LIE ip J3 
for (і = 0; i < DEILE; i++) í /* Arbeiten mit DFILE-Datei */ 
for (ӯ = 0; ӯ < 10; j++) { /* Rückkehrschleife */ 
if (CdSearchFile(&(dfile[i].finfo), dfile[i].fname) != 0) 
break; 


/* Unterbrechung der Retry-Schleife bei normaler Beendigung */ 
else 


printf("$s not found.\n", dfile[i].fname); 


/* Lesen der Datei von CD-ROM */ 
static void datafile read() 
{ 

int Xe 


int cnt; 


for (і = 0; i < DFILE; i++) { /* Arbeiten mit DFILE-Datei */ 
for (ӯ = 0; j < 10; 3++) { /* Retry-Schleife */ 
CdReadFile(dfile[i].fname,dfile[i].addr,dfile[i].finfo.size); 


/* Normales Verarbeiten mit other side of read */ 


/* Anzeige der verbleibenden Anzahl der Sektoren bis zur Beendigung des Lesevorgangs */ 


while ((cnt = CdReadSync(1, 0)) > 0) 
VSync(0); /* Warten auf vertikale 
Synchronisation (für 


Zeitanpassung */ 


LE bent sess 0) 


break; /* Unterbrechung der Retry-Schleife bei normaler 


Beendigung */ 


/* Vorbereitung für Sound-Playback vom Speicher */ 
static void init sound() 
í 
/* Offnen von VAB und Ubertragung zum Sound-Puffer */ 
vab = SsVabTransfer( (u_char*)VH_ADDR, (u_char*)VB_ADDR, -1, 1 ); 
if (vab < O) ( 
printf("SsVabTransfer failed (%d)\n", vab); 


return; 


/* Offnen von SEQ */ 
seq = SsSeqOpen((u_long *)SEQ ADDR, vab); 
if (seq < O) 
printf("SsSeqOpen failed (%d)\n", seq); 


/* Sound-Playback Start */ 
static void play sound() 


{ 


SsSetMVol (MVOL, MVOL); /* Main volume-Finstellung*/ 

SsSeqSetVol(seq, SVOL, SVOL); /* Volume-Einstellung für jedes 
SEQ */ 

SsSeqPlay(seq, SSPLAY PLAY, SSPLAY INFINITY);/* Playback-Schalter ON 
КА 


/* Sound-Playback Beendigung */ 





static void stop sound() 

{ 
SsSeqStop (seq); /* Playback-Schalter OFF */ 
VSync(0); 
VSync(0); 
SsSeqClose(seq); /* SEQ schlieñen */ 
SsVabClose(vab); /* VAB schlieñen */ 


/* Ende von Quellcode */ 


Zusatzliche Lektüre 





Folgende Bücher kónnen Ihnen bei der Erstellung von Net Yaroze Anwendungen behilflich sein. 


C Programmierung 


Titel Verleger ISBN 

The C Programming Language Prentice Hall ISBN 0-13-110362-8 
Teach Yourself C McGrav-Hill ISBN 0-07-882011-1 
Programming with GNU Software О Reilly ISBN 0-56592-112-7 
Graphiken 

Titel Verleger ISBN 

3D Computer-Graphiken O Reilly ISBN 0-201-63186-5 
Encyclopedia of Graphic File Addison-Wesley ISBN 1-56592-058-9 


Formats 


Installierungs-Handbuch 
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